Fork 工作流

Fork 工作流是开源项目常用的协作模式，贡献者无需直接访问源仓库。

什么是 Fork 工作流

Fork 工作流允许任何贡献者参与项目开发：

Fork 源仓库到个人账号
在个人仓库开发
通过 Pull Request 提交贡献
维护者审核后合并

Fork 工作流流程

Bash

┌─────────────────────────────────────────────────────┐
│                    源仓库（upstream）                │
│                    main: A → B → C                   │
└─────────────────────────────────────────────────────┘
                         ↑
                    PR Merge
                         │
┌─────────────────────────────────────────────────────┐
│                Fork 仓库（origin）                   │
│                main: A → B → C → D → E               │
│                         ↑      ↑                     │
│                      rebase   feature分支            │
└─────────────────────────────────────────────────────┘

Fork 工作流步骤

步骤1：Fork 仓库

Bash

# 在 GitHub/GitLab 上点击 Fork 按钮
# Fork 到个人账号

步骤2：克隆个人仓库

Bash

# 克隆 Fork 的仓库
git clone https://github.com/yourname/project.git

# 添加源仓库作为上游
git remote add upstream https://github.com/original/project.git

# 查看远程仓库
git remote -v
# origin    https://github.com/yourname/project.git (fetch)
# upstream  https://github.com/original/project.git (fetch)

步骤3：同步上游更新

Bash

# 获取上游更新
git fetch upstream

# 合入上游 main
git checkout main
git merge upstream/main

# 或使用 rebase
git rebase upstream/main

# 推送到个人仓库
git push origin main

步骤4：创建功能分支

Bash

# 创建新分支
git checkout -b feature/new-feature

# 开发并提交
git add .
git commit -m "Add new feature"

# 推送到个人仓库
git push origin feature/new-feature

步骤5：创建 Pull Request

Bash

# 在 GitHub 上创建 PR
# 从 yourname/project:feature 到 original/project:main

步骤6：同步并更新 PR

text

# PR 期间上游有更新
git fetch upstream
git checkout feature/new-feature
git rebase upstream/main

# 推送更新 PR
git push origin feature/new-feature -f

Fork 工作流优势

优势	说明
开放协作	无需权限即可贡献
独立开发	个人仓库自由开发
安全可控	维护者审核合并
清晰追溯	PR 记录贡献历史

常见场景

场景	操作
开源贡献	Fork → 开发 → PR
团队协作	Fork → Review → Merge
实验开发	Fork → 尝试 → 丢弃

Fork vs 直接协作

特性	Fork 工作流	直接协作
权限要求	无需权限	需要写权限
适用场景	开源项目	团队内部
代码审核	强制 PR	可选审核
灵活性	个人仓库独立	共享仓库

Fork 工作流是参与开源项目的标准方式。

要点总结

Fork 源仓库到个人账号
添加 upstream 远程仓库
定期同步 upstream 更新
在功能分支开发后创建 PR
rebase upstream 保持 PR 最新